home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 1 / The Arsenal Files (Arsenal Computer).ISO / novell / ngm176.exe / RELNOTE.TXT < prev   
Text File  |  1993-10-18  |  19KB  |  481 lines
  1. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  2. *                                                                     *
  3. *               SNADS for NetWare Global MHS v1.0 revC                *
  4. *               Copyright (C) 1992-1993 by Novell, Inc.               *
  5. *                                                                     *
  6. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  7.  
  8.  
  9. The name of this product was changed from NetWare Global
  10. Messaging SNADS Protocol Module to SNADS for NetWare Global
  11. MHS after the product documentation was printed.  The product
  12. name has not yet been changed in the documentation.
  13.  
  14. This version of SNADS for NetWare Global MHS requires NetWare Global
  15. MHS v2.0B.
  16.  
  17.  
  18. This release note lists enchanced features and provides
  19. documentation corrections, trouble-shooting hints and other
  20. information of which you need to be aware.
  21.  
  22.  
  23. Features
  24. ========
  25.  
  26. The SNADS protocol module provides the following features:
  27.  
  28.         *       Transfers messages between NetWare Global MHS and
  29.                 SNADS endpoints using an existing SNA network.
  30.  
  31.         *       Provides support for the SNA communications protocols.
  32.  
  33.         *       Supports connections via direct token ring, ethernet, or
  34.                 SDLC to an SNA wide area network.  (Note that the
  35.                 connection parameters for ethernet are the same as the
  36.                 connection parameters for token ring.
  37.  
  38.         *       Supports one or more LU6.2 sessions and up to two PU2.0 or
  39.                 2.1 connections.
  40.  
  41.         *       Supports automatic directory synchronization between
  42.                 DISOSS and NetWare Global MHS.
  43.  
  44.         *       Supports SMF extended addresses.
  45.  
  46.         *       Allows you to choose whether header information (such
  47.                 as To:, From:, Subject:, cc:, and Date:) will be
  48.                 included in messages sent to SNADS.
  49.  
  50.         *       Allows you to choose whether original messages will be
  51.                 included in messages replied to by SNADS users.
  52.  
  53.  
  54. Extended Address Support
  55. ========================
  56.  
  57. A new feature in SNADS for NetWare Global MHS allows SNADS
  58. users to include SMF extended addresses in messages sent to
  59. NetWare Global MHS. Because SNADS users can now include
  60. address extensions in their messages, the Global MHS server
  61. administrator no longer needs to define users with extended
  62. addresses in the SNADS Auto-Registration Table.
  63.  
  64. Some environments, such as fax and X.400, require special address
  65. information. To support these environments, the SMF protocol
  66. contains an extended address field. For example, to send a message
  67. to Sharon Carstairs through a fax gateway, a NetWare Global MHS
  68. user would address the message to Sharon Carstairs@FaxGate
  69. {Fax:1-555-1234/Sharon Carstairs}.
  70.  
  71. However, SNADS does not support extended addresses. To enable
  72. SNADS users to send to these environments, the SNADS protocol
  73. module allows SNADS users to include extended addresses in their
  74. messages.
  75.  
  76. SNADS users can enter extended addresses in one (and only one) of
  77. the following three locations: at the beginning of the message; in
  78. the subject; or at the beginning of the document. The SNADS
  79. protocol module scans these three locations in the order in which
  80. they are listed. If it finds an extended address in one of these
  81. locations, it will ignore any extended addresses in the others.
  82.  
  83. An extended address definition begins with two open angle brackets
  84. (<<) and ends with two closed angle brackets (>>). Between the
  85. beginning and ending markers are one or more address extensions,
  86. separated by one or more spaces. Thus, the syntax of the extended
  87. address definition is as follows:
  88.  
  89.        <<extension definition(s)>>
  90.  
  91. Each extension definition has one of the following formats:
  92.  
  93.        dgn.den={extended address}
  94.  
  95.        dgn.den=(extended address)
  96.  
  97.        dgn.den="extended address"
  98.  
  99. where dgn.den is a recipient specified in the address (TO and CC)
  100. fields.  The extended address can be enclosed in braces, parentheses, or
  101. double quotation marks.
  102.  
  103. If a message has only one recipient, the dgn.den= can be omitted
  104. from the extended address definition.
  105.  
  106. For example,  Pam Pratt is a SNADS user who wants to send a
  107. message to Sharon Carstairs. Messages for Sharon are routed
  108. through NetWare Global MHS to a fax gateway. Pam creates the following
  109. message:
  110.  
  111.        TO:       FAXGATE.SCARSTAI
  112.  
  113.        SUBJECT:  <<{Fax:1-555-1234/Sharon Carstairs}>>
  114.  
  115. Because the message is addressed to only one user, Pam does not
  116. include the dgn.den=.
  117.  
  118. Consider a second example. Pam Pratt wants to send a message to
  119. Sharon Carstairs, Jack Smith, a Global MHS user, and Donna White, an
  120. X.400 user.  Messages for Donna are routed through NetWare Global MHS to
  121. an X.400 Gateway.  Pam creates the following message:
  122.  
  123.        TO:      FAXGATE.SCARSTAI
  124.                 NEWYORK.JSMITH
  125.                 X400GATE.DWHITE
  126.  
  127.        SUBJECT: Monthly Update
  128.  
  129.                 <<
  130.  
  131.                 FAXGATE.SCARSTAI={Fax:1-555-1234/Sharon Carstairs}
  132.  
  133.                 X400GATE.DWHITE={X400:C=US;A=Publicmail;P=ABC;O=ABC;
  134.                 G=Donna;S=White}
  135.  
  136.                 >>
  137.  
  138.                 Sharon and Donna:  The update will be delayed one
  139.                 day.  We will be sending it tomorrow.
  140.  
  141. Because the message is addressed to more than one user, Pam must
  142. include the dgn.den=.
  143.  
  144.  
  145. SNADS Protocol Module Training
  146. ==============================
  147.  
  148. Self-paced study course #1760, titled Administering SNADS for
  149. NetWare Global MHS, is available. NetWare Global MHS training
  150. course #750 provides comprehensive instruction in installation,
  151. configuration, and administration of the NetWare Global MHS
  152. software.
  153.  
  154. For more information about either of these training courses, call
  155. (800) 233-3382 or (801) 429-5508, or contact your local Novell
  156. authorized education center.
  157.  
  158. Contacting Novell Messaging Technical Support
  159.  
  160. Should you need technical support for NetWare Global MHS,
  161. contact your Novell reseller, or Novell at (800) NETWARE or (801)
  162. 429-5588.
  163.  
  164.  
  165. Documentation Corrections
  166. =========================
  167.  
  168.  
  169. NetWare Global Messaging SNADS Protocol Module Administrator's Guide
  170. --------------------------------------------------------------------
  171.  
  172. p. 6-2, Step 3b
  173.  
  174. Enter the NetWare Global MHS address for the user.
  175.  
  176. If the user is not defined in the local Global MHS database, the
  177. username part of the NGM Name must be the same as the user's DEN.  For
  178. example, a SNADS user sends a message to Ron Simpson, an SMTP user.
  179. Ron's Unix ID is RSIMPSON, so the SNADS user addresses the message to
  180. the DEN "RSIMPSON." Therefore, the username part of Ron's NGM Name must
  181. also be "RSIMPSON." Similarly, a SNADS user sends a message to Donna
  182. White, an X.400 user.  The SNADS user addresses the message to the DEN
  183. DWHITE.  Therefore, the username part of Donna's NGM Name must also be
  184. DWHITE.
  185.  
  186. If a user's address includes an extended address (for example, if the
  187. user is an X.400 user), you must include the extended address when you
  188. enter the user's NGM Name.  For example, Donna White is an X.400 user.
  189. Therefore, her NGM Name must include her X.400 address.  It would be in
  190. the format "DWHITE@X400GATE {X400:C=US;A=PUBLICMAIL;P=ABC;O=ABC;G=Donna;
  191. S=White}".
  192.  
  193.  
  194. p. 7-8, no. 4
  195.  
  196. Add the following after no. 4:
  197.  
  198. 4a.     Define your server's directory synchronization user (NME-CMP-)
  199.         in the SNADS Auto-Registration table.  This step is necessary
  200.         because, in NetWare Global MHS, the address of an NME-CMP- user
  201.         does not contain a workgroup element.  (Messages for NME-CMP-
  202.         users are addressed to NME-CMP-@server.) However, DISOSS
  203.         requires that every user address contain a workgroup element.
  204.  
  205. p. 7-8, no. 5
  206.  
  207. After configuring DISOSS and NetWare Global MHS for directory
  208. synchronization, you MUST force a full directory reconciliation to
  209. initiate the directory synchronization feature.
  210.  
  211. p. 7-12, Step 7
  212.  
  213. Change the Directory Sync Address for the DISOSS node to
  214. NME-CMP-@<workgroup>, where <workgroup> is the workgroup name for the
  215. DGN to which the DISOSS NME-CMP- user belongs.  Ensure that this
  216. workgroup's SNADS alias is its DGN.
  217.  
  218. p. 7-13
  219.  
  220. Before forcing a full directory reconciliation, add your server's
  221. NME-CMP- user to the SNADS auto-registration table.  Refer to page 5-2
  222. for detailed instructions.  The user's NGM name must be
  223. NME-CMP-@<server> (where <server> is the name of your server).  The
  224. user's SNADS DUN must be <dgn>.NME-CMP- (where the <dgn> is the same as
  225. the SNADS REN assigned to your server).
  226.  
  227. p. 7-13
  228.  
  229. You MUST force a full directory reconciliation to initiate the directory
  230. synchronization feature.
  231.  
  232. p. 7-29
  233.  
  234. The DDN for a remote directory synchronization user must be the same as
  235. the user's REN.  In the example entry, the DDN and REN should both be
  236. "LA."
  237.  
  238. p. 7-34
  239.  
  240. Note:  If a new update is generated when the Directory Parcels Status
  241. list contains 40 unsent updates, the oldest update in the list is
  242. deleted.
  243.  
  244. p. 8-4, Step 1f,
  245. p. 8-9, Step 1f, p. C-4
  246.  
  247. SNADS.NEW is located in <ngmfiles>/SNADS.
  248.  
  249. p. 8-5, Step 2d,
  250. p 8-10, Step 2d, p. C-2
  251.  
  252. The NGMSNADS log is located in <ngmfiles>/LOG.
  253.  
  254. p. B-4
  255.  
  256. Add the following to the list of [NGMSNADS] parameters:
  257.  
  258. Maximum-Recipients=<nnn>
  259.         (Optional) If the maximum number of recipients for which your
  260.         SNADS node is configured is less than 256 (the default), use
  261.         this parameter.  The SNADS protocol module will split a message
  262.         addressed to more than <nnn> recipients into multiple messages.
  263.  
  264. add-outgoing-text-headers=TRUE | FALSE
  265.         (Optional) Specify whether you want message headers (To:, From:,
  266.         Subject:, cc:, and Date:) included on messages sent to SNADS.
  267.         The default value is "FALSE."
  268.  
  269. append-note-to-reply=TRUE | FALSE
  270.         (Optional) Specify whether you want the original message appended
  271.         to the note when SNADS users reply to Global MHS users.
  272.         The default value is "FALSE."
  273.  
  274.  
  275. AS/400 Supplement for the NetWare Global Messaging SNADS Protocol Module
  276. Administrator's Guide
  277. ------------------------------------------------------------------------
  278.  
  279. p. 3
  280.  
  281. Add the following note after the fourth bullet:
  282.  
  283.         Note:  If you are using NetWare for SAA PC Support, you must
  284.         define an additional Device Description for SNADS for Global
  285.         MHS.  It cannot use the same Device Description as NetWare for
  286.         SAA PC Support, because the Device for SNADS for Global MHS
  287.         must be single-session enabled.
  288.  
  289. p. 10, step 6e
  290.  
  291. Add the following parameters and values:
  292.  
  293.         Parameter                       Value
  294.         MIN_CONWINNERS_SOURCE             0
  295.         MIN_CONWINNERS_TARGET             1
  296.  
  297. p. 14, step 5
  298.  
  299. Change the values for the following keywords to:
  300.  
  301.         Keyword                         Value
  302.         LCLCTLSSN                         1
  303.         PREESTSSN                         1
  304.  
  305.  
  306.  
  307. Troubleshooting Hints
  308. =====================
  309.  
  310. For detailed troubleshooting instructions, refer to Chapter 8 of the
  311. NetWare Global Messaging SNADS Protocol Module Administrator's
  312. Guide. Following are suggestions for troubleshooting common problems.
  313.  
  314.  
  315. Problem:
  316. Messages from SNADS are remaining in the NGM queue, with the following
  317. workgroup name:
  318.      -unauthorized-.workgroup
  319.  
  320. Action:
  321. This error occurs if you are using a limited-user version of the SNADS
  322. protocol module. The NetWare Global MHS recipient is not defined as
  323. an authorized user. Add the user to the list of authorized users,
  324. following the instructions in Chapter 6 of the guide.
  325.  
  326.  
  327. Problem:
  328. The SNADS node is rejecting messages received from the SNADS protocol module.
  329.  
  330. Action:
  331. Check the maximum number of recipients for which your SNADS node is
  332. configured. If it is less than 256, add the following parameter to
  333. the [NGMSNADS] section of your server's NGM.CFG file:
  334.  
  335.      Maximum-Recipients=<nnn>
  336.  
  337. where <nnn> is the maximum number of recipients your SNADS node will
  338. accept. For more information about NGM.CFG, refer to Appendix B of the guide.
  339.  
  340.  
  341. Problem:
  342. Global MHS users are receiving non-delivery notifications that contain
  343. no explanation of the reason for non-delivery.
  344.  
  345. Action:
  346. a.      If you are using a limited-user version of SNADS for Global MHS,
  347.         make sure the sender has been authorized to send messages to
  348.         SNADS.  Refer to chapter 6 of the "NetWare Global Messaging
  349.         SNADS Protocol Module Administrator's Guide" for detailed
  350.         instructions.
  351.  
  352. b.      Check for communication problems.  This error occurs if there is
  353.         an unrecoverable communication error while SNADS for Global MHS
  354.         is transmitting a message to the SNADS node.
  355.  
  356.  
  357. Problem:
  358. Messages from SNADS are arriving at their destination in binary format.
  359. The destination server does not connect to SNADS directly, but through
  360. an intermediate server.
  361.  
  362. Action:
  363. a.     (Recommended solution) In the SNADS directory, do not define
  364.        servers that connect to SNADS indirectly.  Instead, define their
  365.        DGNs as belonging to the server that does connect directly.  For
  366.        example, Server1 connects to SNADS directly; Server2 communicates
  367.        with SNADS through Server1.  Server2 has two workgroups,
  368.        Personnel (SNADS alias=PERSONNE) and Finance (SNADS
  369.        alias=FINANCE).  In the SNADS directory, PERSONNE and FINANCE are
  370.        defined as DGNs at Server1.
  371.  
  372. b.     If you prefer to define indirectly-connected servers in the
  373.        SNADS directory, ensure that the SNADS alias for the
  374.        directly-connecting server contains the aliases for all servers
  375.        to which it routes messages received from SNADS.  For example, if
  376.        Server2 (RGN=ACME, REN=SERVER2) is defined in the SNADS
  377.        directory, you must define the following SNADS alias for Server1
  378.        (RGN=ACME, REN=SERVER1):
  379.  
  380.        ACME.SERVER1,ACME.SERVER2
  381.  
  382.  
  383.  
  384. Problem:
  385. Directory information received from DISOSS is not being integrated
  386. into the Global MHS database.
  387.  
  388. Action:
  389. Ensure that your Global MHS server subscribes to the DISOSS workgroups.
  390. For more information, refer to Chapter 7 of the guide.
  391.  
  392.  
  393. General Information
  394. ===================
  395.  
  396. This section provides additional information about the SNADS
  397. protocol module.
  398.  
  399.         *       If a session terminates while the SNADS protocol module is
  400.                 delivering a message to SNADS, the SNADS protocol module
  401.                 will resend the message during the next session. If the
  402.                 message was delivered successfully before the termination
  403.                 occurred, two copies of the message might be delivered to the
  404.                 SNADS recipient.
  405.  
  406.         *       When a DISOSS user sends a message to a NetWare Global
  407.                 MHS distribution list, DISOSS receives a DIA status (delivery
  408.                 report) from each of the list members. Since the list member
  409.                 names do not match the original recipient name (the
  410.                 distribution list), the message status is not updated.
  411.  
  412.                 For example, a DISOSS user sends a message to a NetWare
  413.                 Global MHS list called "Managers." NetWare Global MHS
  414.                 distributes the message to John Smith and Mary Adams, the
  415.                 list members. DISOSS receives DIA statuses from John and
  416.                 Mary, but it does not receive one from "Managers," the
  417.                 original recipient. Therefore, it does not update the message
  418.                 status.
  419.  
  420.         *       SMF short names can only include letters, numbers, and the
  421.                 following special characters: #, $, and -. To ensure
  422.                 compatibility between SNADS and NetWare Global MHS, do
  423.                 not use unsupported characters (such as spaces) in SNADS
  424.                 names.
  425.  
  426.         *       If you are using DISOSS Directory Synchronization,
  427.                 workgroups in your organization must not include both
  428.                 DISOSS and NetWare Global MHS users.
  429.  
  430.         *       SNADS for Global MHS cannot detect the Keyword
  431.                 document translation program (DOCXLT) when it is
  432.                 auto-loaded by NGM.  If document translations are not
  433.                 being invoked,  unload DOCXLT and reload it manually.
  434.  
  435.         *       The Keyword document translation program (DOCXLT) has
  436.                 an auto-detection feature that allows it to determine
  437.                 a document type.  However, this feature might identify
  438.                 a binary file as type TEXT, and attempt to convert it.
  439.                 This results in corruption of the file.
  440.  
  441.  
  442. Copyright 1993 Novell, Inc. All rights reserved. No part of this
  443. publication may be reproduced, photocopied, stored on a retrieval system,
  444. or transmitted without the express written consent of the publisher.
  445.  
  446.                     Novell, Inc.
  447.                     2180 Fortune Drive
  448.                     San Jose, CA 95131
  449.                     U.S.A.
  450.  
  451. Disclaimer
  452. ==========
  453. Novell, Inc. makes no representations or warranties with respect to the
  454. contents or use of this manual, and specifically disclaims any express or
  455. implied warranties of merchantability or fitness for any particular purpose.
  456. Further, Novell, Inc. reserves the right to revise this publication and to
  457. make changes to its content, at any time, without obligation to notify any
  458. person or entity of such revisions or changes.
  459.  
  460. Further, Novell, Inc. makes no representations or warranties with respect
  461. to any NetWare software, and specifically disclaims any express or implied
  462. warranties of merchantability or fitness for any particular purpose. Further,
  463. Novell, Inc. reserves the right to make changes to any and all parts of
  464. NetWare software, at any time, without any obligation to notify any
  465. person or entity of such changes.
  466.  
  467. Trademarks
  468. ==========
  469. NetWare and Novell are registered trademarks and NetWare MHS,
  470. NetWare Global MHS, NGM, and SNADS for NetWare Global MHS are
  471. trademarks of Novell, Inc. NetWire is a service mark of Novell, Inc.
  472.  
  473. UNIX is a registered trademark of UNIX System Laboratories, Inc. (USL). USL is
  474. a wholly owned subsidiary of Novell, Inc.
  475.  
  476. IBM and AS/400 are registered trademarks of International Business
  477. Machines Corp.
  478.  
  479. SNADS for NetWare Global MHS v1.0 Release Note
  480. October 1993
  481.